home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / comm2 / umsrfc11.lha / UMS / Doc / english / umsrfc.txt < prev    next >
Text File  |  1995-12-09  |  76KB  |  2,189 lines

  1. UMS RFC Documentation
  2. *********************
  3.  
  4.    Welcome to UMS RFC, a package to handle mail and news messages which
  5. conform to the RFC standards with UMS.
  6.  
  7.    If you have used the UMS UUCP package you should reread the complete
  8. documentation. Almost everthing has changed!
  9.  
  10. Copyright and other legal stuff
  11. *******************************
  12.  
  13. COPYRIGHT
  14. =========
  15.  
  16.    Copyright (C) 1992-95 Stefan Becker
  17.  
  18.    Permission is granted to make and distribute verbatim copies of this
  19. manual provided the copyright notice and this permission notice are
  20. preserved on all copies.
  21.  
  22.    No program, document, data file or source code from this software
  23. package, neither in whole nor in part, may be included or used in other
  24. software packages unless it is authorized by a written permission from
  25. the author.
  26.  
  27. NO WARRANTY
  28. ===========
  29.  
  30.    There is no warranty for this software package. Although the author
  31. has tried to prevent errors, he can't guarantee that the software
  32. package described in this document is 100% reliable. You are therefore
  33. using this material at your own risk. The author cannot be made
  34. responsible for any damage which is caused by using this software
  35. package.
  36.  
  37. DISTRIBUTION
  38. ============
  39.  
  40.    This software package is freely distributable. It may be put on any
  41. media which is used for the distribution of free software, like Public
  42. Domain disk collections, CDROMs, FTP servers or bulletin board systems.
  43.  
  44.    In order to ensure the integrity of this software package,
  45. distributors should use the original archive file umsrfc0_11.lha. The
  46. author cannot be made responsible if this software package has become
  47. unusable due to modifications of the archive contents or of the archive
  48. file itself.
  49.  
  50.    There is no limit on the costs of the distribution, e.g. for the
  51. media, like floppy disks, streamer tapes or compact disks, or the
  52. process of duplicating.  Such limits have been proven to be harmful to
  53. the idea of freely distributable software, e.g. instead of reducing the
  54. price of the floppy disk below the limit, the software was simply
  55. removed from the master disk.
  56.  
  57.    Although the author does not impose any limit on the distribution of
  58. this software package, he would like to express his personal opinions
  59. on this matter:
  60.  
  61.    * This software package should be made available to everyone free of
  62.      charge whenever it is possible.
  63.  
  64.    * If you have acquired this software package under normal conditions
  65.      from a Public Domain dealer on a floppy disk at a price higher
  66.      than 5DM or US $5, then you have definitely paid too much. Please
  67.      don't support this improper profit making any longer and switch to
  68.      a cheaper source as soon as possible.
  69.  
  70. USAGE RESTRICTIONS
  71. ==================
  72.  
  73.    No program, document, data file or source code from this software
  74. package, neither in whole nor in part, may be used on any machine which
  75. is used
  76.  
  77.    * for the research, development, construction, testing or production
  78.      of weapons or other military applications. This also includes any
  79.      machine which is used in the education for any of the above
  80.      mentioned purposes.
  81.  
  82.    * by people who accept, support or use violence against other
  83.      people, e.g.  citizens from foreign countries.
  84.  
  85. A short tour through UMS, RFC and UUCP
  86. **************************************
  87.  
  88.    This chapter tries to give you a short overview about all UMS RFC
  89. related topics.
  90.  
  91. Universal Message System
  92. ========================
  93.  
  94.    UMS is a database system specifically designed for the storage of
  95. mail and news messages. It has some special features which are
  96. explained in this section.
  97.  
  98.    For further information please read the documentation supplied with
  99. UMS.
  100.  
  101. Standard UMS message format
  102. ---------------------------
  103.  
  104.    UMS uses only one format for all messages. This makes it possible
  105. to handle different kinds of networks, like FIDO or UUCP, with one
  106. system. The user only needs to use message reader and all tools work
  107. automatically with all messages. Messages can easily be exchanged
  108. between different kinds of networks.
  109.  
  110.    Messages from the outside have to be converted to this format before
  111. handing them to UMS (importing). They also have to be converted from
  112. this format when transferring messages from UMS to a network
  113. (exporting). These conversions are handled by special programs called
  114. Importers or Exporters. In UMS RFC the conversion is handled by the
  115. umsrfc.library which is used by all programs.
  116.  
  117. UMS address formats
  118. ...................
  119.  
  120.    RFC addresses are mapped 1:1 to UMS addresses. Additionally UMS RFC
  121. currently understands the following two UMS address formats. It can
  122. convert them to and from RFC addresses:
  123.  
  124. <zone>:<hub>/<node>.<point>@fidonet
  125.      FIDO (FTN) address format
  126.  
  127. <box>.maus
  128.      Maus address format
  129.  
  130. Additional message information
  131. ..............................
  132.  
  133.    UMS RFC supports several parameters which can be  specified  in  the
  134. UMS message field Attributes:
  135.  
  136. ALIAS
  137.      Use this alias for the address generation instead of rfc.username.
  138.      UMS RFC checks if this alias is valid for the creator of the
  139.      message.
  140.  
  141. RECEIPT-REQUEST
  142.      Send a receipt message to the specified address. This creates the
  143.      RFC header Return-Receipt-To. The address may be specified in
  144.      one of the following four different forms:
  145.  
  146.           ""                      - Creates address for sender of message
  147.           <name>                  - Creates address for local user
  148.           <account@domain>        - Any address may be specified
  149.           <name>,<account@domain> - Any address may be specfied
  150.  
  151. URGENT
  152.      Flag this message as urgent. This creates the following RFC header:
  153.  
  154.           Priority: urgent
  155.  
  156. UMS <-> RFC conversion
  157. ......................
  158.  
  159.    UMS itself is not a RFC system, which means that all messages must
  160. be transformed from the RFC format to the UMS format and vice versa. Not
  161. every piece of RFC information is used or stored by UMS, so the importer
  162. must preserve the original information. All RFC header fields which are
  163. not known to the importer are preserved.
  164.  
  165.    There are two exceptions to this rule:
  166.  
  167.    - The order of the RFC header fields is not always preserved.
  168.      Luckily, the RFC standards do not impose a strict order for most
  169.      of the header fields.
  170.  
  171.    - If the message is a MIME message and the importer can decode the
  172.      information, the exporter will not reconstruct the original
  173.      message text.  Instead it will create new MIME headers which
  174.      specify the new format.
  175.  
  176.    The exporters use the additional information which is stored by the
  177. importers to reconstruct the original messages. Here are some examples
  178. where preserving of the information is needed:
  179.  
  180. From
  181. Reply-To
  182.      These RFC fields contain the address and maybe the real name of
  183.      the user.  Since this information is stored in two separate UMS
  184.      fields these lines must be parsed to extract the needed
  185.      information. This parsing process is not reversible.
  186.  
  187. Newsgroups
  188.      Crosspostings are stored as hard-linked messages, which appear in
  189.      different groups. But an importer for a system may not have write
  190.      access to all groups in the crossposting, so exporters can't
  191.      reconstruct this line by reading all hard-linked messages.
  192.  
  193. References
  194.      UMS only uses one message ID for message threading.
  195.  
  196.    Mapping of RFC headers to UMS fields:
  197.  
  198.      RFC header   | UMS fields                            | Preserved
  199.      ----------------------------------------------------------------
  200.      Control      | - (cancel commands will be processed) |   Yes
  201.      Date         | Date & CDate                          |
  202.      Distribution | Distribution                          |
  203.      Followup-To  | ReplyGroup                            |
  204.      From         | FromAddr & FromName (MIME decoded)    |   Yes
  205.      In-Reply-To  | ReferID                               |   Yes
  206.      Message-ID   | MessageID                             |
  207.      Newsgroups   | Group (X messages hard linked)        |   Yes
  208.      Organization | Organization (MIME decoded)           |
  209.      References   | ReferID (the last id in the header)   |   Yes
  210.      Reply-To     | ReplyAddr & ReplyName (MIME decoded)  |   Yes
  211.      Subject      | Subject (MIME decoded)                |
  212.      X-Mailer     | Newsreader                            |
  213.      X-NewsReader | Newsreader                            |
  214.      <all others> | Comment                               |   Yes
  215.  
  216.    All control messages will be written to a special newsgroup called
  217. rfc.control. You have to make sure that this newsgroup is included in
  218. the WRITEACCESS pattern of the importer user entries. You can allow
  219. the distribution of control messages by adding this newsgroup to the
  220. READACCESS pattern of a exporter user entry.
  221.  
  222.    Additional UMS fields used for creation of RFC headers during export:
  223.  
  224.      UMS field          | RFC header
  225.      -----------------------------------------------------------------------
  226.      Attributes         | (miscellaneous)
  227.      LogicalToAddr/Name | To (mail only, superseeds ToAddr)
  228.      RfcAttr            | - (contents directly transferred into RFC message)
  229.      ToAddr/Name        | To (mail only, also used as physical address)
  230.  
  231. UMS message base
  232. ----------------
  233.  
  234.    All UMS messages are stored in a message base. This is a special
  235. database controlled by the umsserver. Knowledge about exact format of
  236. this database is not needed by the users because they don't access it
  237. directly. They have to go through the standard Interface
  238. ums.library.
  239.  
  240.    Multiple message bases can be active at the same time, each
  241. controlled by its own umsserver. Even a message base on a remote
  242. machine can  be accessed via network. All the user has to do is to
  243. specify  the  name  of the message base:
  244.  
  245. <name>
  246.      Use the specified message base on the local machine.
  247.  
  248. <name>@<machine>
  249.      Use the specified message base on a remote machine using Envoy as
  250.      network software.
  251.  
  252. <machine>:<service>
  253. <machine>:<port>
  254.      Access a message base on a remote machine using TCP-IP as network
  255.      software. The message base will be specified with the
  256.      configuration on the remote machine.
  257.  
  258. Different types of users
  259. ------------------------
  260.  
  261.    UMS differentiates three types of users:
  262.  
  263. Users
  264.      They can read and write messages, but they don't have any special
  265.      rights.
  266.  
  267. System Operators
  268.      Users with special rights, also called SysOps. They may access the
  269.      headers of messages from other users to perform special tasks.
  270.      Note that they can't read the message text itself, only the
  271.      headers!
  272.  
  273. Exporters
  274.      Users with special read and write rights. They get read rights to
  275.      all messages which should be exported. They may also import
  276.      messages from remote systems.
  277.  
  278.    UMS RFC needs one user with the name postmaster. It will send all
  279. error messages as mail to this user. Normally you should add the alias
  280. postmaster to a SysOp user entry.
  281.  
  282. UMS operation modes
  283. -------------------
  284.  
  285.    UMS can be operated in three different modes for news distribution:
  286.  
  287. Leaf node
  288.      The last system in a news message distribution chain. It imports
  289.      news messages from one or more remote systems, but doesn't export
  290.      those news messages to other systems. Only local news messages are
  291.      exported to the remote systems. Most users should use this mode,
  292.      because it's very easy to maintain.
  293.  
  294.      To make UMS behave like a leaf node use
  295.  
  296.           ( NodeMode "%")
  297.  
  298. Full node
  299.      This node is located inside a news message distribution chain. It
  300.      imports news messages from remote systems and exports them to
  301.      other remote systems. The maintainer of such a system must control
  302.      the message flow between the systems very carefully in order to
  303.      prevent loops and duplicate messages. Only experienced users
  304.      should use this mode.
  305.  
  306.      With the UMS configuration variable NodeMode you can specify
  307.      which newsgroups should be handled by UMS in full node mode, e.g.
  308.  
  309.           ( NodeMode "comp.#?" )
  310.  
  311.      All messages in newsgroups whose names match this pattern may be
  312.      read by other exporters. The actual message flow between the
  313.      systems is controlled with the variable READACCESS in the
  314.      exporter user entries.
  315.  
  316. Gateway
  317.      Such a node behaves like a full node, but additionally it can
  318.      distribute news messages between networks with different
  319.      technologies and newsgroup names. Such systems are very delicate
  320.      to handle, can cause many headaches and create many enemies and
  321.      flame wars. Only VERY VERY experienced users should use this
  322.      mode. You have been warned!
  323.  
  324.      To operate UMS as gateway you have to have a special key, the
  325.      GateKey.
  326.  
  327.    This scheme is only applied to news messages, because they can
  328. generate a very high amount of traffic in the networks. Mail messages
  329. are always freely distributed between all systems.
  330.  
  331. Request for comments
  332. ====================
  333.  
  334.    RFC are standards which define the Internet technology. Each RFC has
  335. a unique number by which it can be identified, e.g. RFC 822. Currently
  336. there are over 1700 RFC available, although some of the older ones have
  337. been obsoleted by newer ones.
  338.  
  339.    The following RFC define the standards for mail and news messages and
  340. their transportation across networks.
  341.  
  342. The standard RFC message formats
  343. --------------------------------
  344.  
  345.    Two standards define the format of messages on the Internet:
  346.  
  347. RFC 822 (1982)
  348. Standard for the format of ARPA Internet text messages
  349.      Defines the format of messages on the Internet. It is therefore
  350.      the most important standard for a RFC compliant messages handling
  351.      system. A message consists of two parts: the header and the body.
  352.      They are seperated by an empty line.
  353.  
  354.      The header consists of non-empty lines with a keyword, followed by
  355.      a colon and the parameters. The standard defines many keywords,
  356.      their semantics and the syntax of their parameters. Especially it
  357.      specifies the format of time and address parameters. An example
  358.      message header looks like this:
  359.  
  360.           From: "Joe Dumb User" <jduser@test.foo.bar>
  361.           To: "John Doe" <jd@dummy.do.main>
  362.           Subject: Test message
  363.           Date: Fri, 26 May 1995 13:25:07 +0100
  364.           Message-ID: <54208434@test.foo.bar>
  365.  
  366.      The standard doesn't define any format for the mody of a message.
  367.      The only restriction is that only 7 Bit ASCII characters may be
  368.      used. This restriction may be circumvented with MIME.
  369.  
  370. RFC 1036 (1987)
  371. Standard for Interchange of USENET Messages
  372.      This is the extension of RFC 822 for news messages. It defines
  373.      some new keywords, like Newsgroups and Path. Also some of the
  374.      many allowed variants in RFC 822 are narrowed down to a usable set
  375.      of options.
  376.  
  377. Multi-Purpose Message Extensions
  378. --------------------------------
  379.  
  380.    RFC 822 concentrates on the format of the message headers and
  381. doesn't say much about the format of the message body. The body may
  382. therefore only be used for plain text. Additionally it allows only 7
  383. Bit ASCII as charset for messages.
  384.  
  385.    These restrictions, especially when the biggest hype of the  90's
  386. called Multimedia hit the  message  handling  systems,  led  to
  387. development  of several extensions to RFC 822 called MIME:
  388.  
  389. RFC 1521 (1993)
  390. MIME Part I: Mechanisms for Specifying and Describing
  391. the Format of Internet Message Bodies
  392.      This defines a structure for the message body. The body may contain
  393.      Non-ASCII text and binary data. The encoding of the message body
  394.      for transportation over non-transparent links is specified.
  395.      Messages may be composed of several different types of data. A
  396.      mechanism for splitting up large messages into several smaller
  397.      ones is specified.
  398.  
  399.      Additionally it defines some new RFC header fields which identify
  400.      a MIME message and specify the contents and the encoding of the
  401.      message body.
  402.  
  403. RFC 1522 (1993)
  404. MIME Part II: Message Header Extensions for Non-ASCII Text
  405.      Specifies the encoding of Non-ASCII text in RFC message headers.
  406.      This allows you to use such texts in subjects.
  407.  
  408.    UMS RFC currently only supports  the  decoding  of  message  headers
  409. and bodies on import and the encoding of message bodies on export. So
  410. you may use all  ISO-8859-1  characters  in  the  message  body,  like
  411. äá and ß.
  412.  
  413. Network News Transfer Protocol
  414. ------------------------------
  415.  
  416.    USENET, the biggest news distribution system of the world, originally
  417. used UUCP as transportation mechanism. But with the advent of the
  418. Internet with its online connections a new mechanism was needed. This
  419. led to the development of the NNTP:
  420.  
  421. RFC 977 (1986)
  422. Network News Transfer Protocol
  423.      This standard specifies a synchronous protocol between two news
  424.      exchanging entities, a client and a server. The client plays the
  425.      active role and sends commands, like POST or GROUP, to the
  426.      server.  It then waits for a response of the server which contains
  427.      status or error codes or the news message. Only after that the
  428.      client may send the next command.
  429.  
  430.      A special protocol is defined if the client is also a news server.
  431.      The client announces which new messages are available from its
  432.      system and the server can request or reject them. This lowers the
  433.      network traffic because messages are only transferred once even if
  434.      there are multiple redundant distribution paths available for a
  435.      message.
  436.  
  437. Post Office Protocol (Version 3)
  438. --------------------------------
  439.  
  440.    On systems where user mailboxes are not available network-wide
  441. because of a missing network file system or security reasons the mail
  442. messages are usually received by one host. This central server plays
  443. the role of a post office which handles the mailboxes for its users.
  444. The server can be accessed using POP3.
  445.  
  446. RFC 1081 (1988)
  447. Post Office Protocol - Version 3
  448.      Defines the synchronous protocol between a server and a client.
  449.      Note that the client can only retrieve messages. For sending mail
  450.      messages he has to use another protocol like SMTP.
  451.  
  452.      First the client has to send the user name and the password to gain
  453.      access to the mailbox. The client may then retrieve messages from
  454.      the mailbox. It may also mark messages for deletion, but the
  455.      server will physically delete the messages only after the client
  456.      has send the command to close the connection.
  457.  
  458. Simple Mail Transfer Protocol
  459. -----------------------------
  460.  
  461.    One of the first applications for the Internet was the exchange of
  462. electronic mail. Several protocols for transferring mail messages over
  463. networks have been defined, but the most commonly used one is SMTP.
  464.  
  465. RFC 821 (1982)
  466. Simple Mail Transfer Protocol
  467.      Defines a synchronous protocol between two mail exchanging
  468.      entities. The calling party plays the active role which can be
  469.      changed during the conversation, but this option seldomly used.
  470.      For each mail the active part first transmits the senders address
  471.      and then a list with the recipient addresses. These addresses are
  472.      checked by the receiving side.  After that the mail message is
  473.      transferred.
  474.  
  475. Internet protocol stack
  476. -----------------------
  477.  
  478.    TCP/IP is the most commonly used abbreviation for protocol suite
  479. used on the Internet. Although there are several other protocols in use
  480. the most important are IP and TCP.
  481.  
  482. IP - Internet Protocol
  483.      Defines an unreliable, connectionless datagram service which is
  484.      the base for all Internet protocols and services. IP datagrams
  485.      contain a destination adddress which enables the interconnecting
  486.      systems to route a datagram from the sender to the recipient. The
  487.      addresses, the so called IP numbers, are 32 Bit wide. The arrival
  488.      and the order of the datagrams is not guaranteed with IP.
  489.  
  490.      IP can be used on many different types of network hardware.
  491.      Examples are Ethernet, FDDI, serial lines (SLIP, CSLIP or PPP) or
  492.      X.25.
  493.  
  494. TCP - Transmission Control Protocol
  495.      Defines a reliable, connection oriented stream protocol. From the
  496.      point of the user the connection looks like a FIFO, that is the
  497.      bytes arrive in the same order as he sends them. TCP splits the
  498.      stream into datagrams and reassembles them at the receiving side.
  499.      It also makes sure that the datagrams are placed correctly when
  500.      they arrive out of order. Lost or errorneous datagrams are
  501.      requested again from the sender.
  502.  
  503. Unix to Unix CoPy
  504. =================
  505.  
  506.    UUCP was originally written to transfer files to a remote UNIX
  507. machine.  The syntax of the main command uucp is the same as the UNIX
  508. cp command hence the name. Each file transfer request creates a job
  509. which is stored in the so called spool directory for the remote system.
  510.  
  511.    At certain times the local machine checks if there are any files
  512. waiting to be transferred to the remote system. It then starts the
  513. command uucico (Unix to Unix Copy In Copy Out) which automatically
  514. contacts the remote system via a modem line or a TCP-IP connection.
  515. The remote system then starts its own uucico and both programs
  516. process their jobs and send the files forth and back.
  517.  
  518.    Even remote command execution is possible with UUCP. To achieve this
  519. a job with three files is created. Two of them are data files with the
  520. prefix D.. One of these contains the data and the other the commands
  521. how to process the data file on the remote system. The third file with
  522. the prefix C. contains the commands for uucico to send both files
  523. to the remote system.
  524.  
  525.    The command file is renamed to a file with the prefix X. on the
  526. remote system. After the connection has been closed uucico starts the
  527. command uuxqt (Unix to Unix eXeCuTion?). It looks into the spool
  528. directory for files with the prefix X. and processes the commands.
  529.  
  530.    This mechanism can be also used to transfer mail and news messages
  531. (The news distribution system USENET was originally based on UUCP). The
  532. data file contains a message in the Message Formats format and the
  533. command file contains mail and news processing commands, like
  534. rmail.
  535.  
  536.    Only mail messages are transferred in this way nowadays, because
  537. small files degrade the performance of the file transfer. This can be
  538. avoided if the data file contains several messages (batching). News
  539. messages can simply be concatenated into one file, because they already
  540. contain the message length in the header. For mail messages an adaption
  541. of the SMTP format is used, called Batched SMTP (BSMTP).
  542.  
  543.    To reduce the amount of data which needs to be transferred batched
  544. files are usually compressed. Currently in use are three compression
  545. methods: compress, freeze and gzip. Normally only the plain output of
  546. those programs is stored in the data file, but compressed news batches
  547. usually contain a small text header which identifies the compression
  548. method.
  549.  
  550. Requirements for using UMS RFC
  551. ******************************
  552.  
  553.    This version of UMS RFC requires the following things:
  554.  
  555.    * AmigaOS 2.04 (V37) or better.
  556.  
  557.    * UMS V11 or better.
  558.  
  559.    * AmiTCP 3.0 or better if you are using TCP-IP.
  560.  
  561.    * A service provider for Mail and News via UUCP or TCP-IP (NNTP,
  562.      POP3 or SMTP).
  563.  
  564. Description of all directories in this distribution
  565. ***************************************************
  566.  
  567.    UMS RFC uses the standard UMS directory structure, so you can easily
  568. unpack the distribution into your UMS directory.
  569.  
  570. UMS/Bin
  571.      UMS RFC programs and some utility programs. Add this  directory
  572.      to  your command path.
  573.  
  574. UMS/Devs
  575.      Contains the telser.device.
  576.  
  577. UMS/Docs/english
  578.      Documentation (ASCII and AmigaGuide) for UMS RFC in english.
  579.  
  580. UMS/Libs
  581.          umsrfc.library and some utility libraries. Copy these to your
  582.      LIBS: directory or add this directory to your LIBS: path with
  583.  
  584.           Assign LIBS: UMS/Libs ADD
  585.  
  586. UMS/Networks/RFC/convert
  587.      Scripts to import existing mail and news messages from other UUCP
  588.      packages into an Message Base.
  589.  
  590. UMS/Networks/RFC/db
  591.      Example configuration files for telser. Copy these to the
  592.      directory AMITCP:db
  593.  
  594. UMS/Networks/RFC/lib
  595.      Example configuration files for UUCP. Copy these to the directory
  596.      UULIB:
  597.  
  598. UMS/Networks/RFC/src
  599.      This directory contains the History file with the complete story
  600.      about the development of UMS RFC and its predecessors.
  601.  
  602. How to configure UMS RFC
  603. ************************
  604.  
  605.    UMS RFC offers many options and this chapter explains the
  606. configuration.  Please read it carefully because a proper configuration
  607. is essential for the correct operation of UMS RFC.
  608.  
  609. AmigaDOS environment variables
  610. ==============================
  611.  
  612.    Only one environment variable is currently used by UMS RFC:
  613.  
  614. UMSUUCP.mb
  615.      This variable tells the command uuxqt which Message Base it should
  616.      use to import UUCP batches.
  617.  
  618. UMS configuration variables
  619. ===========================
  620.  
  621.    Most of the options are configured using the UMS variables which are
  622. explained in this section.
  623.  
  624. Domain name for your system
  625. ---------------------------
  626.  
  627. rfc.domainname
  628.      The fully qualified domain name (FQDN) for your system. The FQDN
  629.      consists of the hostname plus the name of your domain. This
  630.      variable is mandantory for using UMS RFC.
  631.  
  632.    Example:
  633.  
  634.      ( rfc.domainname "foobar.earth.sol.galaxy" )
  635.  
  636. Path name for your system
  637. -------------------------
  638.  
  639. rfc.pathname
  640.      The name of your system in the "Path:" line for news messages. If
  641.      your system is a registered UUCP node, then this variable only
  642.      needs to contain the hostname of your system. Otherwise it must
  643.      contain the FQDN of your system.  This variable is mandantory
  644.      for using UMS RFC. See also rfc.domainname.
  645.  
  646.    Example for normal nodes:
  647.  
  648.      ( rfc.domainname "foobar.earth.sol.galaxy" )
  649.      ( rfc.pathname   "foobar.earth.sol.galaxy" )
  650.  
  651.    Example for registered UUCP nodes:
  652.  
  653.      ( rfc.domainname "foobar.earth.sol.galaxy" )
  654.      ( rfc.pathname   "foobar" )
  655.  
  656. Account name for a local UMS RFC user
  657. -------------------------------------
  658.  
  659. rfc.username
  660.      This is the account name for a user. This variable is
  661.      mandantory for every UMS user whose messages are exported
  662.      with UMS RFC. The user entry also must contain an alias for this
  663.      name.
  664.  
  665.    Example:
  666.  
  667.      ( rfc.domainname "foobar.earth.sol.galaxy" )
  668.      
  669.      ( User
  670.        ( Name "Joe Dumb User" )
  671.        ( Alias "jduser" )
  672.        ...
  673.        ( rfc.username "jduser" )
  674.      )
  675.  
  676.    The above example will result in the following Internet address for
  677. the user:
  678.  
  679.      jduser@foobar.earth.sol.galaxy
  680.  
  681. Daylight Saving Time on/off
  682. ---------------------------
  683.  
  684. rfc.dstime
  685.      This switch enables the Daylight Saving Time. The default is
  686.      N.
  687.  
  688.    Example:
  689.  
  690.      ( rfc.dstime "Y" )
  691.  
  692. Address conversions during message export
  693. -----------------------------------------
  694.  
  695. rfc.export.*
  696.      This set of variables specificies the domain names used in the
  697.      address conversion for exporting messages from non RFC compliant
  698.      nets. Currently defined are the conversions for Fido (FTN) and
  699.      Maus, using the following variables:
  700.  
  701.           rfc.export.fido  (Default: .fidonet.org)
  702.           rfc.export.maus  (Default: .maus.de)
  703.  
  704.    Example:
  705.  
  706.      ( rfc.export.fido ".fido.de" )
  707.      ( rfc.export.maus ".maus.sub.org" )
  708.  
  709.    The above example will result in the following address conversion:
  710.  
  711.      Joe User,1:2/3.4@fidonet  ->  Joe_User@p4.f3.n2.z1.fido.de
  712.      Joe User,HB.maus          ->  Joe_User@HB.maus.sub.org
  713.  
  714. Address conversions during message import
  715. -----------------------------------------
  716.  
  717. rfc.import.*
  718.      This set of  variables  specificies  the  domain  names  used  in
  719.      the  address conversion for importing messages arriving from a RFC
  720.      compliant net, but  which originate in a non RFC compliant net.
  721.      You may specify several domain names  for each type of net,
  722.      separated by commas. Currently defined  are  the  conversions for
  723.      Fido (FTN) and Maus, using the following variables:
  724.  
  725.           rfc.import.fido  (Default: .fidonet.org)
  726.           rfc.import.maus  (Default: .maus.de)
  727.  
  728.    Example:
  729.  
  730.      ( rfc.import.fido ".fido.de,.fidonet.org" )
  731.      ( rfc.import.maus ".maus.sub.org" )
  732.  
  733.    The above example will result in the following address conversion:
  734.  
  735.      Joe_User@p4.f3.n2.z1.fidonet.org  ->  Joe User,1:2/3.4@fidonet
  736.      Joe_User@p4.f3.n2.z1.fido.de      ->  Joe User,1:2/3.4@fidonet
  737.      Joe_User@HB.maus.sub.org          ->  Joe User,HB.maus
  738.  
  739. Encoding of mail message texts during export
  740. --------------------------------------------
  741.  
  742. rfc.mailencoding
  743.      When exporting mail messages which contain non-ASCII characters for
  744.      transportation over non-transparent (that is 8 bit clean) links,
  745.      UMS RFC can encode them according to the MIME standard. The
  746.      following values are allowed for this variable:
  747.  
  748.           0  Don't encode (Default)
  749.           1  Encode as quoted-printable
  750.  
  751.    Example:
  752.  
  753.      ( rfc.mailencoding 1 )
  754.  
  755. Encoding of news message texts during export
  756. --------------------------------------------
  757.  
  758. rfc.newsencoding
  759.      When exporting news messages which contain non-ASCII characters for
  760.      transportation over non-transparent (that is 8 bit clean) links,
  761.      UMS RFC can encode them according to the MIME standard. The
  762.      following values are allowed for this variable:
  763.  
  764.           0  Don't encode (Default)
  765.           1  Encode as quoted-printable
  766.  
  767.    Example:
  768.  
  769.      ( rfc.newsencoding 1 )
  770.  
  771. Name of your system for Received: lines
  772. ---------------------------------------
  773.  
  774. rfc.receivedname
  775.      With this variable you can set the name of your system for the
  776.      Received: lines. If you don't set this variable then the
  777.      contents of rfc.domainname will be used. This variable is needed
  778.      for systems with dynamic domain names.
  779.  
  780.    Example:
  781.  
  782.      ( rfc.domainname   "pop3host.domain" )
  783.      ( rfc.receivedname "host.sub.domain" )
  784.  
  785.    This will create the following lines in the RFC header:
  786.  
  787.      ...
  788.      Received: by host.sub.domain ...
  789.      ...
  790.      From: user@pop3host.domain
  791.      ...
  792.  
  793. Access rights for remote NNTP clients
  794. -------------------------------------
  795.  
  796. nntpd.access
  797.      When a remote client tries to connect the NNTP service the umsnntpd
  798.      server daemon reads the contents of this variable to find out
  799.      which access rights the client has. The variable may contain
  800.      multiple lines of the following format:
  801.  
  802.           <Name pattern> <UMS user name>,<Post Y/N>,<Server Y/N>
  803.  
  804.      The check is based on the domain name of the machine on which the
  805.      client runs. The patterns from the first line down to the last
  806.      line will be used to match the domain name. When a pattern matches
  807.      then the access rights of this entry are used for the client. If
  808.      no pattern matches the access is denied with an error message.
  809.  
  810.      The account of the specified UMS user name is used to export and
  811.      import the news messages. If the second parameter is set to Y
  812.      then posting (that is importing) of news messages with the
  813.      POST command is allowed. If the third parameter is also set
  814.      to Y then the client is a NNTP server and is allowed to use the
  815.      IHAVE command for transferring news messages.
  816.  
  817.    Example:
  818.  
  819.      ( nntpd.access
  820.         "localhost       NNTP1,Y,Y\\n"
  821.         "*.ping.de       NNTP2,Y,N\\n"
  822.         "*               NNTP3,N,N\\n" )
  823.  
  824.    The above example allows full access for a client running on the
  825. local machine. Clients running on machines in the domain ping.de are
  826. allowed to post news messages. All other machines are only allowed to
  827. read news messages. Using three different UMS users you can control
  828. which newsgroups are visible for each of the three categories using the
  829. READACCESS variable.
  830.  
  831. NNTP server log on/off
  832. ----------------------
  833.  
  834. nntpd.log
  835.      This variable enables the command logging of the NNTP server to
  836.      the UMS log file. The default is N.
  837.  
  838.    Example:
  839.  
  840.      ( nntpd.log "Y" )
  841.  
  842. Group list for news message import
  843. ----------------------------------
  844.  
  845. nntpget.groups
  846.      The NNTP importer umsnntpget looks into this variable to find out
  847.      which newsgroups it should request from the remote server. It may
  848.      contain multiple lines. If you are using the option -g each line
  849.      must contain one newsgroup name. If you don't use this option then
  850.      each line may contain multiple group name patterns seperated by
  851.      commas and even negations.
  852.  
  853.    Example (use with option -g):
  854.  
  855.      ( nntpget.groups "group.a\\n"
  856.                       "group.b\\n"
  857.                       "group.d\\n"
  858.                       "de.test.a\\n"
  859.                       "foo.bar.a\\n"
  860.                       "foo.bar.b\\n" )
  861.  
  862.    Example (use without option -g):
  863.  
  864.      ( nntpget.groups "group.*,!group.c,de.test.a\\n"
  865.                       "foo.bar.*\\n" )
  866.  
  867. SMTP server log on/off
  868. ----------------------
  869.  
  870. smtpd.log
  871.      This variable enables the command logging of the SMTP server to
  872.      the UMS log file. The default is N.
  873.  
  874.    Example:
  875.  
  876.      ( smtpd.log "Y" )
  877.  
  878. Configuration for mail batches
  879. ------------------------------
  880.  
  881. uucp.mailexport
  882.      This variable tells the UUCP exporter ums2uucp in which format
  883.      mail messages should be exported. The syntax is as follows:
  884.  
  885.           <command>[,<grade>[,<batch>[,<compress command>[,<header>[,<max size>]]]]]
  886.  
  887.     command
  888.           Command name for the C line in the UUCP command file. You
  889.           have to talk to the administrator of your host which commands
  890.           his software accepts and how it interprets them. The
  891.           following table shows some common names for mail batches:
  892.  
  893.                Name    | Meaning
  894.                -----------------------------------------------
  895.                rmail   | unbatched, uncompressed mail
  896.                rbsmtp  | batched, uncompressed mail
  897.                rcbsmtp | batched, compressed (compress) mail
  898.                rbcsmtp | batched, compressed (compress) mail
  899.                rfbsmtp | batched, compressed (freeze) mail
  900.                rbfsmtp | batched, compressed (freeze) mail
  901.                rgbsmtp | batched, compressed (gzip) mail
  902.                rbgsmtp | batched, compressed (gzip) mail
  903.  
  904.     grade
  905.           Every UUCP job has a grade which is one letter out of
  906.           0..9A..Z or a..z. It specifies the transfer
  907.           priority for the job.  0 has the highest priority and
  908.           z the lowest. The default is A.
  909.  
  910.     batch
  911.           This optional parameter specifies if several mail message
  912.           should be merged into one file (batching).
  913.  
  914.     compress command
  915.           Name of a command for the optional compression of the data
  916.           files. Legal values are compressfreeze and gzip. If
  917.           you leave this field empty the data files won't be compressed.
  918.  
  919.     header
  920.           If this field is not empty, then the following header line
  921.           will be created in the data file:
  922.  
  923.                #! <header text>
  924.  
  925.           Mail batches normally don't contain any headers, so you may
  926.           leave this field empty.
  927.  
  928.     max size
  929.           Maximum size for one batch file. When it reaches this size it
  930.           will be closed and a new batch file will be used. The default
  931.           size is 65536 bytes.
  932.  
  933.    Example for unbatched, uncompressed mail:
  934.  
  935.      ( uucp.mailexport "rmail" )
  936.  
  937.    Example for batched, uncompressed mail, no header, batch size 65536
  938. Bytes:
  939.  
  940.      ( uucp.mailexport "rbsmtp,A,Y" )
  941.  
  942.    Example for batched, compressed mail, no header, batch size 300000
  943. Bytes:
  944.  
  945.      ( uucp.mailexport "rcbsmtp,0,Y,compress,,300000" )
  946.  
  947. Configuration for news batches
  948. ------------------------------
  949.  
  950. uucp.newsexport
  951.      This variable tells the UUCP exporter ums2uucp in which format
  952.      news messages should be exported. The syntax is as follows:
  953.  
  954.           <command>[,<grade>[,<batch>[,<compress command>[,<header>[,<max size>]]]]]
  955.  
  956.     command
  957.           Command name for the C line in the UUCP command file. You
  958.           have to talk to the administrator of your host which commands
  959.           his software accepts and how it interprets them. Normally you
  960.           should set this to rnews.
  961.  
  962.     grade
  963.           Every UUCP job has a grade which is one letter out of
  964.           0..9A..Z or a..z. It specifies the transfer
  965.           priority for the job.  0 has the highest priority and
  966.           z the lowest. The default is A.
  967.  
  968.     batch
  969.           This optional parameter specifies if several news message
  970.           should be merged into one file (batching). Usually
  971.           non-batched news transfer is a bad idea.
  972.  
  973.     compress command
  974.           Name of a command for the optional compression of the data
  975.           files. Legal values are compressfreeze and gzip. If
  976.           you leave this field empty the data files won't be compressed.
  977.  
  978.     header
  979.           If this field is not empty, then the following header line
  980.           will be created in the data file:
  981.  
  982.                #! <header text>
  983.  
  984.           The following table shows some common header texts:
  985.  
  986.                Name     | Meaning
  987.                ------------------------------------------------
  988.                cunbatch | batched, compressed (compress) news
  989.                funbatch | batched, compressed (freeze) news
  990.                gunbatch | batched, compressed (gzip) news
  991.  
  992.           You should talk to the administrator of your host which
  993.           headers and compression types are supported by the software
  994.           of the host system.
  995.  
  996.     max size
  997.           Maximum size for one batch file. When it reaches this size it
  998.           will be closed and a new batch file will be used. The default
  999.           size is 65536 bytes.
  1000.  
  1001.    Example for batched, uncompressed news, no header, batch size 300000
  1002. Bytes:
  1003.  
  1004.      ( uucp.newsexport "rnews,A,Y,,,300000" )
  1005.  
  1006.    Example for batched, compressed news, with header (#! cunbatch),
  1007. batch size 65536 Bytes:
  1008.  
  1009.      ( uucp.newsexport "rnews,B,Y,compress,cunbatch" )
  1010.  
  1011. UUCP node name for your system
  1012. ------------------------------
  1013.  
  1014. uucp.nodename
  1015.      UUCP node name for your system. This name should not be longer than
  1016.      7 characters.
  1017.  
  1018.    Example:
  1019.  
  1020.      ( uucp.nodename "foobar" )
  1021.  
  1022. Name of the file for debugging output
  1023. -------------------------------------
  1024.  
  1025. uucp.debugfile
  1026.      Output file for error logs. Useful only for debugging.
  1027.  
  1028.    Example:
  1029.  
  1030.      ( uucp.logfile "t:uucp.log" )
  1031.  
  1032. Debug level
  1033. -----------
  1034.  
  1035. uucp.debuglevel
  1036.      Set the highest log level. Messages with a higher level are not
  1037.      logged.  Useful only for debugging.
  1038.  
  1039.    Example:
  1040.  
  1041.      ( uucp.loglevel 5 )
  1042.  
  1043. Smart or dump UUCP host
  1044. -----------------------
  1045.  
  1046. uucp.dumbhost
  1047.      Set this to Y when your host requires RFC976 style UUCP mail
  1048.      envelopes. Default is to generate normal envelopes. With a given
  1049.      address and date, a normal envelope looks like this:
  1050.  
  1051.           From <user>@<domain> <date>
  1052.  
  1053.      A RFC976 envelope looks like this:
  1054.  
  1055.           From <user> <date> remote from <domain>
  1056.  
  1057.      Ask the administrator of your host what envelope type is expected
  1058.      by the software used on the host system.
  1059.  
  1060.    Example:
  1061.  
  1062.      ( uucp.dumbhost "Y" )
  1063.  
  1064. Filter CR characters
  1065. --------------------
  1066.  
  1067. uucp.filtercr
  1068.      If this variable is set to Y then incoming UUCP data files are
  1069.      stripped of CR characters before processing them.
  1070.  
  1071.    Example:
  1072.  
  1073.      ( uucp.filtercr "Y" )
  1074.  
  1075. Keep dupe messages
  1076. ------------------
  1077.  
  1078. uucp.keepdupes
  1079.      Normally duplicate messages are flagged as error and the  UUCP  job
  1080.      is not deleted. Sometimes dupes can't be avoided, because UUCP is
  1081.      an offline protocol, that means there is no way to detect dupes on
  1082.      the sending hosts. On a system with several hosts and high traffic
  1083.      this can result in a high number of bad job files lying around,
  1084.      which do not contain real errors. If you set this variable to
  1085.      N then bad jobs, which had only dupe errors, are
  1086.      automatically deleted.
  1087.  
  1088.    Example:
  1089.  
  1090.      ( uucp.keepdupes "N" )
  1091.  
  1092. Log dupe messages
  1093. -----------------
  1094.  
  1095. uucp.logdupes
  1096.      Normally duplicate messages are also logged in the UMS RFC error
  1097.      log. If you don't want to bother with dupes then you should set
  1098.      this to N.  See also uucp.keepdupes.
  1099.  
  1100.    Example:
  1101.  
  1102.      ( uucp.logdupes "N" )
  1103.  
  1104. Mail routing configuration
  1105. --------------------------
  1106.  
  1107. uucp.mailroute
  1108.      Sometimes it's important to specify static routes for outgoing
  1109.      mails.  Normally this variable is empty so NO routing information
  1110.      will be generated. Each line in this variable consists of an
  1111.      address pattern and a list of hosts:
  1112.  
  1113.           <address pattern> [<host1>[,<host2>....]]
  1114.  
  1115.      When the recipient address matches the address pattern and the
  1116.      host list is not empty, then the UUCP exporter ums2uucp will
  1117.      create an explicit mail route. The route information will be added
  1118.      AFTER the address conversion for non RFC compliant nets has been
  1119.      applied.
  1120.  
  1121.      If the variable does contain several lines, then the patterns will
  1122.      be tried from the first line down to the last line until one
  1123.      pattern matches. If no pattern matches, then no route information
  1124.      will be generated.
  1125.  
  1126.    Example:
  1127.  
  1128.      ( uucp.mailroute "#?.maus.de        host1\\n"
  1129.                       "#?.zer.sub.org    host2,host3\\n"
  1130.                       "#?.fidonet.org\\n"
  1131.                       "#?.de             host4\\n" )
  1132.  
  1133.    The following test cases:
  1134.  
  1135.      user@box.maus.de
  1136.      user@box.zer.sub.org
  1137.      user@f7.n242.z2.fidonet.org
  1138.      user@zauber.nase.de
  1139.      user@dummy.blubb.edu
  1140.  
  1141.    are translated to the following mail routes for non-batched mail
  1142. tranfer:
  1143.  
  1144.      C rmail host1!box.maus.de!user
  1145.      C rmail host2!host3!box.zer.sub.org!user
  1146.      C rmail user@f7.n242.z2.fidonet.org
  1147.      C rmail host4!zauber.nase.de!user
  1148.      C rmail user@dummy.blubb.edu
  1149.  
  1150.    and to the following mail routes for batched mail transfer:
  1151.  
  1152.      RCPT TO: <@host1:user@box.maus.de>
  1153.      RCPT TO: <@host2,@host3:user@box.zer.sub.org>
  1154.      RCPT TO: <user@f7.n242.z2.fidonet.org>
  1155.      RCPT TO: <@host4:user@zauber.nase.de>
  1156.      RCPT TO: <user@dummy.blubb.edu>
  1157.  
  1158. Limit number of recipients
  1159. --------------------------
  1160.  
  1161. uucp.recipients
  1162.      Limits the number of recipients for one mail file. If there are
  1163.      more recipients then the UUCP exporter ums2uucp will create
  1164.      several mail files for one mail. The default is to put all
  1165.      recipients in one mail file.
  1166.  
  1167.    Example:
  1168.  
  1169.      ( uucp.recipients 2 )
  1170.  
  1171.    Using the above example on a mail with three recipients will result
  1172. in two separate mails to be send. If unbatched mail transfer is used
  1173. then the following two C lines are generated in the command files:
  1174.  
  1175.      C rmail usera@test1.foo.bar,userb@test2.foo.bar
  1176.      C rmail userc@test3.foo.bar
  1177.  
  1178.    If batched  mail  transfer  is  used  then  the  following  commands
  1179. are generated in the batch file:
  1180.  
  1181.      MAIL FROM: <user@test.foo.bar>
  1182.      RCPT TO: <usera@test1.foo.bar>
  1183.      RCPT TO: <userb@test2.foo.bar>
  1184.      DATA
  1185.      ...
  1186.      MAIL FROM: <user@test.foo.bar>
  1187.      RCPT TO: <userc@test3.foo.bar>
  1188.      DATA
  1189.  
  1190. Description of all UMS RFC commands
  1191. ***********************************
  1192.  
  1193.    This section contains the description of all UMS RFC commands and
  1194. their command line options. The following syntax will be used:
  1195.  
  1196.              -a          Mandantory command line option. You may not omit this
  1197.                          option when using a command.
  1198.      
  1199.              -b <...>    Command line option with parameter. The space between
  1200.                          the option and the parameter is optional.
  1201.      
  1202.              [-c <...>]  Optional command line option. You may omit this option
  1203.                          when using a command. The default value will be used
  1204.                          instead.
  1205.  
  1206.    The following UMS RFC commands are available:
  1207.  
  1208. NNTP exporter
  1209. =============
  1210.  
  1211.    The command umsnntp exports news messages via NNTP to a remote
  1212. host.
  1213.  
  1214.      Syntax:
  1215.      
  1216.              umsnntp  -h <remote host>
  1217.                      [-S <Service name or port number>]
  1218.      
  1219.                      [-p <UMS password>]
  1220.                      [-s <UMS message base>]
  1221.                      [-u <UMS user name>]
  1222.      
  1223.                      [-b <select bit>]
  1224.                      [-i]
  1225.      
  1226.                      [-c]
  1227.                      [-r <n>]
  1228.                      [-w <n>]
  1229.      
  1230.      Defaults:
  1231.      
  1232.                       -S  Service nntp (port 119)
  1233.                       -p  No password
  1234.                       -s  Default message base
  1235.                       -u  User NNTP
  1236.                       -b  No select bit
  1237.                       -r  360
  1238.                       -w  60
  1239.  
  1240.    Explanation of the command line options:
  1241.  
  1242. -b
  1243.      Bit number of an additional select bit. Only messages with this
  1244.      bit set in the user flags will be exported. This can be used to
  1245.      run a special filter program before exporting with umsnntp.
  1246.  
  1247. -i
  1248.      Use the IHAVE command to send the news messages to the remote
  1249.      host. If you don't specify this option, then the POST command is
  1250.      used. Most NNTP servers don't allow the IHAVE command for
  1251.      clients, so you may not be able to use this option.
  1252.  
  1253. -c
  1254.      Export news messages continously. After exporting all new messages
  1255.      umsnntp will a short while and then will start to export all new
  1256.      messages which arrived in the meantime.
  1257.  
  1258. -r
  1259.      Causes umsnntp to rescan the whole message base for new messages
  1260.      after n export runs. All messages which couldn't be sent until
  1261.      now will be sent again. This option is only useful in conjunction
  1262.      with -c.
  1263.  
  1264. -w
  1265.      Causes umsnntp to wait n seconds between two export runs.
  1266.      This option is only useful inconjunction with -c.
  1267.  
  1268.    See also UMS options and Protocol options.
  1269.  
  1270. NNTP importer (server daemon)
  1271. =============================
  1272.  
  1273.    The command umsnntpd is a server daemon which offers a transfer
  1274. service for news messages via NNTP to remote clients. It can only be
  1275. executed by the Internet Super Daemon Inetd.
  1276.  
  1277.      Syntax:
  1278.      
  1279.              umsnntpd [<UMS user name>]
  1280.                       [<UMS password>]
  1281.                       [<UMS message base>]
  1282.      
  1283.      Defaults:
  1284.      
  1285.                       User NNTPD
  1286.                       No password
  1287.                       Default message base
  1288.  
  1289. NNTP importer
  1290. =============
  1291.  
  1292.    The command umsnntp imports news messages via NNTP from a remote
  1293. host.
  1294.  
  1295.      Syntax:
  1296.      
  1297.              umsnntpget  -h <remote host>
  1298.                         [-S <Service name or port number>]
  1299.      
  1300.                         [-p <UMS password>]
  1301.                         [-s <UMS message base>]
  1302.                         [-u <UMS user name>]
  1303.      
  1304.                         [-g]
  1305.                         [-P <n>]
  1306.                         [-c]
  1307.                         [-q]
  1308.      
  1309.      Defaults:
  1310.      
  1311.                          -S  Service nntp (port 119)
  1312.                          -p  No password
  1313.                          -s  Default message base
  1314.                          -u  User NNTP
  1315.                          -P  1
  1316.  
  1317.    Explanation of the command line options:
  1318.  
  1319. -g
  1320.      Use the commands GROUPSTAT and NEXT to scan for new news
  1321.      messages. This may lower the load on the remote NNTP server but
  1322.      the transfer overhead may be significantely higher, especially if
  1323.      the server uses long expiration periods for news messages. If you
  1324.      don't specify this option the command NEWNEWS is used which only
  1325.      transfers information about new messages.
  1326.  
  1327. -P
  1328.      Use n (up to 20) parallel processes to transfer news messages.
  1329.      This is useful to make the transfer of news messages over a slow
  1330.      serial link more efficient by using most of the available
  1331.      bandwidth.
  1332.  
  1333. -c
  1334.      Use parameters on the command line after the last valid command
  1335.      line option as input parameters. You may request news messages by
  1336.      message ID:
  1337.  
  1338.           umsnntpget -h nntphost -c 1234@dummy.do.main 6789@test.foo.bar
  1339.  
  1340.      or by group names:
  1341.  
  1342.           umsnntpget -h nntphost -c -g comp.sys.amiga.misc comp.sys.amiga.datacomm
  1343.  
  1344. -q
  1345.      Don't print message ids.
  1346.  
  1347.    See also UMS options and Protocol options.
  1348.  
  1349. Tool to set date of the last NNTP access
  1350. ========================================
  1351.  
  1352.    The command setnntpdate sets the date of the last NNTP access
  1353. for umsnntpget.
  1354.  
  1355.      Syntax:
  1356.      
  1357.              setnntpdate  <UMS user name>
  1358.                           <UMS password>
  1359.                          [<UMS message base>]
  1360.                          [DATE <date string>]
  1361.      
  1362.      Defaults:
  1363.      
  1364.                           Default message base
  1365.  
  1366.    Explanation of the command line options:
  1367.  
  1368. DATE
  1369.      You have to specify the date as defined in RFC 822.
  1370.      setnntpdate will transform it to the format which is needed
  1371.      for umsnntpget. If you don't specify this option the last access
  1372.      date will be printed in RFC 822 format.
  1373.  
  1374.    Example:
  1375.  
  1376.      setnntpdate NNTP secret DATE "18 Nov 1994 20:05:30"
  1377.  
  1378. POP3 importer
  1379. =============
  1380.  
  1381.    The command umspop3 imports mail messages via POP3 from a remote
  1382. host.
  1383.  
  1384.      Syntax:
  1385.      
  1386.              umspop3  -h <remote host>
  1387.                      [-S <Service name or port number>]
  1388.      
  1389.                      [-p <UMS password>]
  1390.                      [-s <UMS message base>]
  1391.                      [-u <UMS user name>]
  1392.      
  1393.                       -n <mailbox name>
  1394.                       -i <mailbox password>
  1395.                      [-k]
  1396.      
  1397.                      [-c]
  1398.                      [-w <n>]
  1399.      
  1400.      Defaults:
  1401.      
  1402.                       -S  Service pop3 (port 110)
  1403.                       -p  No password
  1404.                       -s  Default message base
  1405.                       -u  User POP3
  1406.                       -w  60
  1407.  
  1408.    Explanation of the command line options:
  1409.  
  1410. -n
  1411.      Name of the mailbox on the remote host.
  1412.  
  1413. -i
  1414.      Password for the mailbox on the remote host.
  1415.  
  1416. -k
  1417.      If this option is used umspop3 won't delete the messages in the
  1418.      mailbox on the remote host. Note that these messages will show up
  1419.      as dupes next time you use umspop3!
  1420.  
  1421. -c
  1422.      Import mail messages continously. After importing all new messages
  1423.      umspop3 will a short while and then will start to import all new
  1424.      messages which arrived in the meantime.
  1425.  
  1426. -w
  1427.      Causes umspop3 to wait n seconds between two export runs.
  1428.      This option is only useful inconjunction with -c.
  1429.  
  1430.    See also UMS options and Protocol options.
  1431.  
  1432. POP3 exporter (server daemon)
  1433. =============================
  1434.  
  1435.    The command umspop3d is a server daemon which offers a transfer
  1436. service for mail messages via POP3 to remote clients. It can only be
  1437. executed by the Internet Super Daemon Inetd.
  1438.  
  1439.      Syntax:
  1440.      
  1441.              umspop3d [<UMS user name>]
  1442.                       [<UMS password>]
  1443.                       [<UMS message base>]
  1444.      
  1445.      Defaults:
  1446.      
  1447.                       User POP3D
  1448.                       No password
  1449.                       Default message base
  1450.  
  1451. SMTP exporter
  1452. =============
  1453.  
  1454.    The command umssmtp exports mail messages via SMTP to a remote
  1455. host.
  1456.  
  1457.      Syntax:
  1458.      
  1459.              umssmtp  -h <remote host>
  1460.                      [-S <Service name or port number>]
  1461.      
  1462.                      [-p <UMS password>]
  1463.                      [-s <UMS message base>]
  1464.                      [-u <UMS user name>]
  1465.      
  1466.                      [-b <select bit>]
  1467.      
  1468.                      [-c]
  1469.                      [-r <n>]
  1470.                      [-w <n>]
  1471.      
  1472.      Defaults:
  1473.      
  1474.                       -S  Service smtp (port 25)
  1475.                       -p  No password
  1476.                       -s  Default message base
  1477.                       -u  User SMTP
  1478.                       -b  No select bit
  1479.                       -r  360
  1480.                       -w  60
  1481.  
  1482.    Explanation of the command line options:
  1483.  
  1484. -b
  1485.      Bit number of an additional select bit. Only messages with this
  1486.      bit set in the user flags will be exported. This can be used to
  1487.      run a special filter program before exporting with umssmtp.
  1488.  
  1489. -c
  1490.      Export mail messages continously. After exporting all new messages
  1491.      umssmtp will wait a short time and then will start to export all
  1492.      new messages which arrived in the meantime.
  1493.  
  1494. -r
  1495.      Causes umssmtp to rescan the whole message base for new messages
  1496.      after n export runs. All messages which couldn't be sent until
  1497.      now will be sent again. This option is only useful in conjunction
  1498.      with -c.
  1499.  
  1500. -w
  1501.      Causes umssmtp to wait n seconds between two export runs.
  1502.      This option is only useful inconjunction with -c.
  1503.  
  1504.    See also UMS options and Protocol options.
  1505.  
  1506. SMTP importer (server daemon)
  1507. =============================
  1508.  
  1509.    The command umssmtpd is a server daemon which offers a transfer
  1510. service for mail messages via SMTP to remote clients. It can only be
  1511. executed by the Internet Super Daemon Inetd.
  1512.  
  1513.      Syntax:
  1514.      
  1515.              umssmtpd [<UMS user name>]
  1516.                       [<UMS password>]
  1517.                       [<UMS message base>]
  1518.      
  1519.      Defaults:
  1520.      
  1521.                       User SMTPD
  1522.                       No password
  1523.                       Default message base
  1524.  
  1525. UUCP exporter
  1526. =============
  1527.  
  1528.    The command ums2uucp exports mail and news messages and creates
  1529. batch files for the transfer via UUCP to a remote host.
  1530.  
  1531.      Syntax:
  1532.      
  1533.              ums2uucp  -h <remote host>
  1534.      
  1535.                       [-p <UMS password>]
  1536.                       [-s <UMS message base>]
  1537.                       [-u <UMS user name>]
  1538.      
  1539.                       [-b <select bit>]
  1540.                       [-d <n>]
  1541.      
  1542.      Defaults:
  1543.      
  1544.                        -p  No password
  1545.                        -s  Default message base
  1546.                        -u  User UUCP
  1547.                        -b  No select bit
  1548.                        -d  0
  1549.  
  1550.    Explanation of the command line options:
  1551.  
  1552. -h
  1553.      UUCP node name of the remote host.
  1554.  
  1555. -b
  1556.      Bit number of an additional select bit. Only messages with this
  1557.      bit set in the user flags will be exported. This can be used to
  1558.      run a special filter program before exporting with ums2uucp.
  1559.  
  1560. -d
  1561.      UUCP log level: 0, 1, 2 or 3.
  1562.  
  1563.    See also UMS options.
  1564.  
  1565. UUCP importer
  1566. =============
  1567.  
  1568.    The command uuxqt imports mail and news messages from batch files
  1569. which were transferred via UUCP from a remote host. This command is
  1570. normally only executed by the UUCP transfer program uucico.
  1571.  
  1572.      Syntax:
  1573.      
  1574.              uuxqt [-p <UMS password>]
  1575.                    [-d <n>]
  1576.                    [<subdirectory>]
  1577.      
  1578.      Defaults:
  1579.      
  1580.                     -p  No password
  1581.                     -d  0
  1582.  
  1583.    Explanation of the command line options:
  1584.  
  1585. -p
  1586.      Password for the UMS user. This will be used for ALL logins.
  1587.  
  1588. -d
  1589.      UUCP log level: 0, 1, 2 or 3.
  1590.  
  1591. subdirectory
  1592.      Name of the subdirectory in the UUCP spool directory. This
  1593.      parameter is supplied by uucico when a hierarchical spool
  1594.      directory structure is used.
  1595.  
  1596.        uuxqt uses the following system for the Users:
  1597.  
  1598.      uucp.default  Used as the first login to read the configuration.
  1599.      
  1600.      uucp.<name>   Used when importing a batch from node name.
  1601.  
  1602. Common UMS related command line options
  1603. =======================================
  1604.  
  1605.    The following UMS related comand line options are understood by most
  1606. of the programs:
  1607.  
  1608. -p
  1609.      Password for the Users.
  1610.  
  1611. -s
  1612.      Name of the Message Base used for importing or exporting.
  1613.  
  1614. -u
  1615.      Name of the Users.
  1616.  
  1617. Common protocol related command line options
  1618. ============================================
  1619.  
  1620.    The following protocol related comand line options are understood by
  1621. most of the programs:
  1622.  
  1623. -h
  1624.      Name or IP number of the remote host.
  1625.  
  1626. -S
  1627.      Name or port number of the TCP-IP service. All services have
  1628.      default port numbers so this option should normally not be used.
  1629.  
  1630. Some example UMS RFC configurations
  1631. ***********************************
  1632.  
  1633. Configuration for an UMS RFC user
  1634. =================================
  1635.  
  1636.    Excerpt from the file ums.config:
  1637.  
  1638.      ( User
  1639.          ( Alias
  1640.              jduser
  1641.              postmaster
  1642.          )
  1643.          ( Readaccess "#?" )
  1644.          ( Writeaccess "#?" )
  1645.          ( Netaccess "#?" )
  1646.          ( Import "%" )
  1647.          ( Name "Joe Dumb User" )
  1648.          ( Password "top secret" )
  1649.          ( rfc.username "jduser" )
  1650.      )
  1651.  
  1652. Configuration for a simple node
  1653. ===============================
  1654.  
  1655.    Excerpt from the file ums.config:
  1656.  
  1657.      ( Aka "#?@test.(foo.bar|uucp)" )
  1658.      ( NodeMode "%" )
  1659.      
  1660.      ( Exporter
  1661.          ( Alias
  1662.              uucp.default
  1663.              NNTP
  1664.              POP3
  1665.              SMTP
  1666.              UUCP
  1667.          )
  1668.          ( Readaccess "#?" )
  1669.          ( Writeaccess "#?" )
  1670.          ( Netaccess "#?" )
  1671.          ( Import "#?" )
  1672.          ( Export "#?" )
  1673.          ( Distribution "#?" )
  1674.          ( Name uucp.dummy )
  1675.          ( Password  )
  1676.          ( rfc.domainname "test.foo.bar" )
  1677.          ( rfc.mailencoding 0 )
  1678.          ( rfc.newsencoding 0 )
  1679.          ( rfc.pathname "test.foo.bar" )
  1680.          ( uucp.dumbhost "Y" )
  1681.          ( uucp.keepdupes "Y" )
  1682.          ( uucp.logdupes "Y" )
  1683.          ( uucp.mailexport "rmail,N" )
  1684.          ( uucp.newsexport "rnews,Y,compress,cunbatch,300000" )
  1685.          ( uucp.nodename "test" )
  1686.      )
  1687.  
  1688.    This system receives all messages from the node dummy. It will
  1689. send out unbatched mail messages and batched, compressed news messages
  1690. to the node dummy. The transmission link to the remote node is
  1691. transparent, so no encoding is needed. The users on this system will
  1692. have the address
  1693.  
  1694.      <user>@test.foo.bar
  1695.  
  1696.    To poll the node dummy with UUCP the user has to use the following
  1697. commands:
  1698.  
  1699.      ums2uucp -h dummy
  1700.      uucico -sdummy
  1701.  
  1702.    To send out mail and news message via TCP-IP and to fetch mail
  1703. messages the user has to use the following commands:
  1704.  
  1705.      umssmtp -h dummy.foo.bar
  1706.      umsnntp -h dummy.foo.bar
  1707.      umspop3 -h dummy.foo.bar -n jduser -i more_top_secret
  1708.  
  1709. Configuration for a full node
  1710. =============================
  1711.  
  1712.    Excerpt from the file ums.config:
  1713.  
  1714.      ( Aka "#?@test.(foo.bar|uucp)" )
  1715.      ( NodeMode "(comp|sci).#?" )
  1716.      
  1717.      ( rfc.domainname "test.foo.bar" )
  1718.      ( rfc.pathname "test.foo.bar" )
  1719.      
  1720.      ( Exporter
  1721.          ( Alias
  1722.              uucp.default
  1723.              UUCP
  1724.          )
  1725.          ( Readaccess "(comp|sci).#?" )
  1726.          ( Writeaccess "(comp|sci).#?" )
  1727.          ( Netaccess "#?" )
  1728.          ( Import "#?" )
  1729.          ( Export "#?.foo.bar" )
  1730.          ( Distribution "#?" )
  1731.          ( Name uucp.dummy )
  1732.          ( Password  )
  1733.          ( rfc.mailencoding 1 )
  1734.          ( rfc.newsencoding 1 )
  1735.          ( uucp.dumbhost "Y" )
  1736.          ( uucp.keepdupes "N" )
  1737.          ( uucp.logdupes "Y" )
  1738.          ( uucp.mailexport "rbsmtp,Y" )
  1739.          ( uucp.newsexport "rnews,Y,gzip,gunbatch" )
  1740.          ( uucp.nodename "test" )
  1741.      )
  1742.      
  1743.      ( Exporter
  1744.          ( Alias
  1745.              NNTPD
  1746.              POP3
  1747.              POP3D
  1748.              SMTP
  1749.              SMTPD
  1750.          )
  1751.          ( Readaccess "#?" )
  1752.          ( Writeaccess "#?" )
  1753.          ( Netaccess "#?" )
  1754.          ( Import "#?" )
  1755.          ( Export "~(#?.foo.bar)" )
  1756.          ( Distribution "#?" )
  1757.          ( Name NNTP )
  1758.          ( Password  )
  1759.          ( rfc.mailencoding 0 )
  1760.          ( rfc.newsencoding 0 )
  1761.      )
  1762.  
  1763.    In this setup the newsgroup hierarchies comp and sci are
  1764. distributed between two systems. Mail messages to the domain
  1765. foo.bar are send out with UUCP, all others are send out with SMTP.
  1766.  
  1767. Configuration for a gateway
  1768. ===========================
  1769.  
  1770.    Excerpt from the file ums.config:
  1771.  
  1772.      ( Netgroup
  1773.          "comp.sys.amiga.misc"
  1774.          "fidonet.comp.sys.amiga.misc"
  1775.      )
  1776.      
  1777.      ( Exporter
  1778.          ( Alias
  1779.              uucp.default
  1780.              NNTP
  1781.              NNTPD
  1782.              POP3
  1783.              POP3D
  1784.              SMTP
  1785.              SMTPD
  1786.              UUCP
  1787.          )
  1788.          ( Readaccess "comp.#?" )
  1789.          ( Writeaccess "comp.#?" )
  1790.          ( Netaccess "#?" )
  1791.          ( Import "#?" )
  1792.          ( Export "~(#?@fidonet)" )
  1793.          ( Distribution "#?" )
  1794.          ( Name uucp.dummy )
  1795.          ( Password  )
  1796.          ( rfc.domainname "test.foo.bar" )
  1797.          ( rfc.mailencoding 0 )
  1798.          ( rfc.newsencoding 0 )
  1799.          ( rfc.pathname "test.foo.bar" )
  1800.          ( uucp.dumbhost "Y" )
  1801.          ( uucp.keepdupes "N" )
  1802.          ( uucp.logdupes "Y" )
  1803.          ( uucp.mailexport "rbsmtp,Y" )
  1804.          ( uucp.newsexport "rnews,Y,gzip,gunbatch" )
  1805.          ( uucp.nodename "test" )
  1806.      )
  1807.  
  1808.    The example shows the UMS RFC part of a gateway configuration. One
  1809. newsgroup is distributed between networks with different technologies
  1810. (gating).
  1811.  
  1812. Security Configuration
  1813. ======================
  1814.  
  1815.    If you are using the commercial version of AmiTCP you may limit the
  1816. access to your system. The file AMITCP:db/inet.access contains the
  1817. rules which services may be used on your system. The following two lines
  1818. allow the access to the services NNTP and SMTP from any host on the
  1819. Internet:
  1820.  
  1821.      smtp    *   allow   LOG
  1822.      nntp    *   allow   LOG
  1823.  
  1824. Configuration for the Internet Super Daemon
  1825. ===========================================
  1826.  
  1827.    The daemons for the NNTP, POP3 and SMTP services are started
  1828. automatically when a remote host accesses those services. Add the
  1829. following three lines to the inetd configuration file
  1830. AMITCP:db/inetd.conf:
  1831.  
  1832.      smtp    stream  tcp nowait root UMS:Bin/umssmtpd umssmtpd
  1833.      pop3    stream  tcp nowait root UMS:Bin/umspop3d umspop3d
  1834.      nntp    stream  tcp nowait root UMS:Bin/umsnntpd umsnntpd
  1835.  
  1836. Services configuration
  1837. ======================
  1838.  
  1839.    To use the services NNTP, POP3 and SMTP the file
  1840. AMITCP:db/services must contain the following lines:
  1841.  
  1842.      smtp    25/tcp
  1843.      pop3    110/tcp
  1844.      nntp    119/tcp
  1845.  
  1846. UUCP directories
  1847. ================
  1848.  
  1849.    UUCP needs three directories for its work:
  1850.  
  1851. Spool directory
  1852.      Directory for command, data and log files. You should assign
  1853.      UUSPOOL: to this directory. Each remote site has its own
  1854.      subdirectory. In each subdirectory there should be a directory
  1855.      bad-jobs for errorneous jobs. Example with two remote systems
  1856.      named dummy and test:
  1857.  
  1858.           1> Dir UUSPOOL: all
  1859.                dummy (dir)
  1860.                     bad-jobs (dir)
  1861.                test (dir)
  1862.                     bad-jobs (dir)
  1863.             logfile                          TimeLog
  1864.             XferStat
  1865.  
  1866. Configuration directory
  1867.      UUCP configuration file reside here. You should assign UULIB: to
  1868.      this directory.
  1869.  
  1870.           1> Dir UULIB:
  1871.             config                           L.Ports
  1872.             L.Sys                            security
  1873.             seq
  1874.  
  1875. Public directory
  1876.      Download and upload area for UUCP. You should assign UUPUB: to
  1877.      this directory.
  1878.  
  1879. Main UUCP configuration
  1880. =======================
  1881.  
  1882.    The file UULIB:config contains the UUCP configuration. A minimal
  1883. configuration only needs your node name, a dummy user name and a
  1884. setting for the debug level:
  1885.  
  1886.      NodeName    foobar
  1887.      UserName    root
  1888.      Debug       0
  1889.  
  1890. UUCP ports description
  1891. ======================
  1892.  
  1893.    The file UULIB:L.Ports describes the devices which uucico uses to
  1894. contact remote systems. Normally this is a serial port with a modem, so
  1895. the file should look like this:
  1896.  
  1897.      acu=ser device=serial.device unit=0
  1898.  
  1899.    If you want to use UUCP over TCP-IP you must add another device to
  1900. this file:
  1901.  
  1902.      acu=tcp device=telser.device unit=0
  1903.  
  1904. Remote UUCP Systems
  1905. ===================
  1906.  
  1907.    The file UULIB:L.Sys describes how uucico can contact remote
  1908. systems. This includes the device to use, the serial line speed, the
  1909. phone number and the login script:
  1910.  
  1911.      dummy    Any   ser   19200    ATDP123456  ogin: foobar ssword: hello
  1912.  
  1913.    To contact a remote system with UUCP over TCP-IP you replace the
  1914. phone number with the hostname of the remote system. So the line should
  1915. look like this:
  1916.  
  1917.      dummy    Any   tcp   19200    dummy    ogin: foobar ssword: hello
  1918.  
  1919. UUCP poll script
  1920. ================
  1921.  
  1922.    The following script first exports all messages to the remote system
  1923. and then contacts it. You can specify the name of the remote system as
  1924. parameter:
  1925.  
  1926.      .KEY SYSTEM
  1927.      .DEF SYSTEM dummy
  1928.      .BRA {
  1929.      .KET }
  1930.      
  1931.      ums2uucp -h {SYSTEM}
  1932.      uucico -s{SYSTEM}
  1933.  
  1934. Telser configuration
  1935. ====================
  1936.  
  1937.    The file AMITCP:db/telser.conf describes the configuration for
  1938. every unit of the telser.device. For the unit 0 it should look like
  1939. this:
  1940.  
  1941.      0  ""    NoOperation NOOPENWIN NOLINGER NODEBUG T:telser.log
  1942.  
  1943. Host descriptions
  1944. =================
  1945.  
  1946.    The file AMITCP:db/telser.hosts contains the descriptions of the
  1947. remote systems. If you dial a remote system using the
  1948. telser.device it looks into this file to find out the hostname
  1949. and the parameters. For our example system it looks like this:
  1950.  
  1951.      dummy    dummy.do.main  540   ""    00000000001
  1952.  
  1953.    Please make sure that the 11th bit is set, because it activates the
  1954. transparent mode of telser.device which is a must for UUCP over
  1955. TCP-IP.
  1956.  
  1957. Solutions to common UMS RFC problems
  1958. ************************************
  1959.  
  1960. Error: No rfc.username for...
  1961.      You have forgotten to add the variable rfc.username to the user
  1962.      entry of a lokal user.
  1963.  
  1964. Error: Can't write article, check WRITEACCESS!
  1965.      UMS RFC couldn't write the article to any newsgroup. You have
  1966.      requested a newsgroup but forgotten to add it to the
  1967.      WRITEACCESS patter of the importer entry. If you are
  1968.      receiving control messages you must also add the newsgroup
  1969.      rfc.control to this pattern!
  1970.  
  1971. Error: Can't get connection data!
  1972.      You forgot to  update  the  service  file  of  your  AmiTCP
  1973.      installation.  See Services.
  1974.  
  1975.    You should also read the FAQ about UMS.
  1976.  
  1977. History of UMS RFC
  1978. ******************
  1979.  
  1980. 0.11 (09-Dec-1995)
  1981.         - POP3 server daemon umspop3d.
  1982.  
  1983.         - Support for UMS' binary field.
  1984.  
  1985.         - Implemented UUCP grades. The format of the variables
  1986.           uucp.mailexport and uucp.newsexport was changed!
  1987.  
  1988.         - Implemented CTRL-C handling for umsnntpget.
  1989.  
  1990.         - Command logging for NNTP and SMTP server daemons.
  1991.  
  1992.         - Switch for Daylight Saving Time.
  1993.  
  1994.         - Several bug fixes and new command switches.
  1995.  
  1996. 0.10 (04-Jun-1995)
  1997.         - First official release of the UMS RFC package the successor
  1998.           of the UMS UUCP package.
  1999.  
  2000.         - All RFC from/to UMS conversions are handled by the
  2001.           umsrfc.library now.
  2002.  
  2003.         - Support for NNTP, POP3, SMTP, UUCP.
  2004.  
  2005.         - New documentation.
  2006.  
  2007.    For all older versions please read the file History in the source
  2008. directory.
  2009.  
  2010. Not yet implemented features
  2011. ****************************
  2012.  
  2013.    The following things have not yet been implemented. The order shown
  2014. below doesn't imply any priority for an item:
  2015.  
  2016.    * MX support for the SMTP exporter umssmtp.
  2017.  
  2018.    * Encoding/Decoding with base64 in MIME messages.
  2019.  
  2020.    * MIME encoding of messages headers.
  2021.  
  2022.    * The address conversion should be freely configurable. Does anyone
  2023.      have a good reference for a pattern search & replace algorithm
  2024.      (like in perl)?
  2025.  
  2026. Where to send bug reports & comments
  2027. ************************************
  2028.  
  2029.    The author can be reached at the following addresses:
  2030.  
  2031. Postal address:
  2032.  
  2033.                 Stefan Becker
  2034.                 Verkehrsstrasse 11
  2035.           44809 Bochum
  2036.                 GERMANY
  2037.  
  2038. Internet Electronic Mail:
  2039.  
  2040.           stefanb@yello.ping.de
  2041.  
  2042. The author wants to thank
  2043. *************************
  2044.  
  2045.    I want to thank all users of the public beta  version  for  testing
  2046. this package. Especially  I  want  to  thank  Matthias  Scheler  and
  2047. Bernhard Möllemann who tested intermediate versions on their systems.
  2048. Many  thanks also  to  the  members  of  the  UMS-Dev  mailing  list
  2049. for   the discussions and the ideas.
  2050.  
  2051.    Thanks go to Kai `wusel' Siering for allowing me to include his
  2052. version of uucico in this package. You may find the latest version of
  2053. the program in his UUCP package called wUUCP on Aminet in the
  2054. directory comm/uucp.
  2055.  
  2056.    Thanks also to Sam Yee for allowing me to include parts of his
  2057. telser package. You may find the latest version of his package on
  2058. Aminet in the directory comm/tcptelser is Shareware, so if you
  2059. use it regularly PLEASE do register it!
  2060.  
  2061. Index
  2062. *****
  2063.  
  2064.  
  2065.  
  2066.  Account name                           rfc.username
  2067.  Address                                Authors address
  2068.  Attributes                             Attributes
  2069.  Bug reports                            Authors address
  2070.  Command Line Options                   Commands
  2071.  Command Syntax                         Commands
  2072.  Comments                               Authors address
  2073.  Common Problems                        Answers
  2074.  Configuration                          Configuration
  2075.  Conversion                             Conversion
  2076.  Copyright                              Copyright
  2077.  Credits                                Credits
  2078.  Daylight Saving Time                   rfc.dstime
  2079.  Directories                            Directories
  2080.  Distribution                           Copyright
  2081.  Domain Name                            rfc.domainname
  2082.  E-Mail                                 Authors address
  2083.  Environment variables                  Environment
  2084.  Examples                               Examples
  2085.  Full Node                              Modes
  2086.  Full Node Configuration                Full Node
  2087.  Gateway                                Modes
  2088.  Gateway Configuration                  Gateway
  2089.  History                                History
  2090.  Host Descripions                       Hosts
  2091.  Inetd Configuration                    Inetd
  2092.  Internet address                       Authors address
  2093.  Internet protocols                     TCP-IP
  2094.  Introduction                           Introduction
  2095.  Leaf Node                              Modes
  2096.  Leaf Node Configuration                Leaf Node
  2097.  Legal stuff                            Copyright
  2098.  MIME                                   MIME
  2099.  Multi-Purpose Message Extensions       MIME
  2100.  Network News Transfer Protocol         NNTP
  2101.  NNTP                                   NNTP
  2102.  NNTP exporter                          umsnntp
  2103.  NNTP importer                          umsnntpget
  2104.  NNTP server daemon                     umsnntpd
  2105.  nntpd.access                           nntpd.access
  2106.  nntpd.log                              nntpd.log
  2107.  nntpget.groups                         nntpget.groups
  2108.  Path name                              rfc.pathname
  2109.  Permissions                            Copyright
  2110.  POP3                                   POP3
  2111.  POP3 importer                          umspop3
  2112.  POP3 server daemon                     umspop3d
  2113.  Post Office Protocol                   POP3
  2114.  Postal address                         Authors address
  2115.  Probibitions                           Copyright
  2116.  Protocol stack                         TCP-IP
  2117.  Questions & Answers                    Answers
  2118.  Remote UUCP Systems                    L.Sys
  2119.  Requirements                           Requirements
  2120.  RFC                                    RFC
  2121.  RFC 1036                               Message Formats
  2122.  RFC 1081                               POP3
  2123.  RFC 1521                               MIME
  2124.  RFC 1522                               MIME
  2125.  RFC 821                                SMTP
  2126.  RFC 822                                Message Formats
  2127.  RFC 977                                NNTP
  2128.  RFC Message Formats                    Message Formats
  2129.  rfc.control                            Conversion
  2130.  rfc.domainname                         rfc.domainname
  2131.  rfc.dstime                             rfc.dstime
  2132.  rfc.export.fido                        rfc.export.
  2133.  rfc.export.maus                        rfc.export.
  2134.  rfc.import.fido                        rfc.import.
  2135.  rfc.import.maus                        rfc.import.
  2136.  rfc.mailencoding                       rfc.mailencoding
  2137.  rfc.newsencoding                       rfc.newsencoding
  2138.  rfc.pathname                           rfc.pathname
  2139.  rfc.receivedname                       rfc.receivedname
  2140.  rfc.username                           rfc.username
  2141.  Security Configuration                 Access
  2142.  Services configuration                 Services
  2143.  setnntpdate                            setnntpdate
  2144.  Simple Mail Transfer Protocol          SMTP
  2145.  SMTP                                   SMTP
  2146.  SMTP exporter                          umssmtp
  2147.  SMTP server daemon                     umssmtpd
  2148.  smtpd.log                              smtpd.log
  2149.  TCP/IP                                 TCP-IP
  2150.  Telser Configuration                   Telser
  2151.  TODO                                   TODO
  2152.  UMS                                    UMS
  2153.  UMS Address Formats                    Addresses
  2154.  UMS configuration variables            UMS Configuration
  2155.  UMS Message Base                       Message Base
  2156.  UMS Message Format                     Message Format
  2157.  UMS Operation Modes                    Modes
  2158.  ums2uucp                               ums2uucp
  2159.  umsnntp                                umsnntp
  2160.  umsnntpd                               umsnntpd
  2161.  umsnntpget                             umsnntpget
  2162.  umspop3                                umspop3
  2163.  umspop3d                               umspop3d
  2164.  umssmtp                                umssmtp
  2165.  umssmtpd                               umssmtpd
  2166.  Unix to Unix CoPy                      UUCP
  2167.  User Configuration                     User
  2168.  Users                                  Users
  2169.  UUCP                                   UUCP
  2170.  UUCP Configuration                     UUCPConfig
  2171.  UUCP Directories                       UUCPDirectories
  2172.  UUCP exporter                          ums2uucp
  2173.  UUCP importer                          uuxqt
  2174.  UUCP poll script                       UUCPPoll
  2175.  UUCP ports description                 L.Ports
  2176.  uucp.debugfile                         uucp.debugfile
  2177.  uucp.debuglevel                        uucp.debuglevel
  2178.  uucp.dumbhost                          uucp.dumbhost
  2179.  uucp.filtercr                          uucp.filtercr
  2180.  uucp.keepdupes                         uucp.keepdupes
  2181.  uucp.logdupes                          uucp.logdupes
  2182.  uucp.mailexport                        uucp.mailexport
  2183.  uucp.mailroute                         uucp.mailroute
  2184.  uucp.newsexport                        uucp.newsexport
  2185.  uucp.nodename                          uucp.nodename
  2186.  uucp.recipients                        uucp.recipients
  2187.  uuxqt                                  uuxqt
  2188.  
  2189.